home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / FLC20.ARJ / FLC20.DOC < prev    next >
Text File  |  1992-08-13  |  7KB  |  182 lines
  1. Program:    FLC - File List Compare Utility
  2. Version:    2.0
  3. Date:       08/13/92
  4. Author:     George Spafford  copyright 1992
  5.  
  6. Purpose:
  7.  
  8. To quickly compare one file list to another and generate a list of unique
  9. files that exist in that list.
  10.  
  11. Procedure:
  12.  
  13. FLC uses configuration files.  By default, it uses FLC.CFG.  If you want to
  14. have different config files for different lists, then you may specify the
  15. name of the config file on the command line.  For example:
  16.  
  17.         FLC WAYNE.CFG
  18.  
  19. This example will use a config file called WAYNE.CFG rather than FLC.CFG.
  20.  
  21. ==========================================
  22. Config File Format:
  23. ==========================================
  24.  
  25. #FLC        :This is a FLC config file - do not remove any lines including this
  26.             :one.  For different configurations, copy this file to another name
  27.             :and edit it.  For more detailed descriptions of the variables in
  28.             :this config file, consult the FLC doc file that comes with this
  29.             :package.  (The FLC program is the copyright of George Spafford.)
  30.  
  31. --------------------------------------------------------------------------------
  32. #BBSLIST:source.lst                             |This list will be compared
  33.                                                 |against #YOURLIST - any
  34.                                                 |files that only exist in
  35.                                                 |#BBSLIST will be listed.
  36.                                                 
  37. #YOURLIST:compare.lst                           |This is the comparison list.
  38.                                                 
  39. #UNIQUELIST:unique.lst                          |Unique files list name
  40.                                                 |(Specify the path if needed)
  41.                                                         
  42. #CRITERIA:                                      |Criteria to base searches on
  43.                                                 |Name is always one, but more
  44.                                                 |can be used: S=Size D=Date
  45.                                                 |Criteria can be all of these,
  46.                                                 |a mixture or even name only
  47.                                                 | - for name only, do not enter
  48.                                                 |anything.
  49.                                
  50. #BBSNAMEPOS:001-012                             |Name position in bytes
  51. #BBSSIZEPOS:018-027                             |Size position in bytes
  52. #BBSDATEPOS:029-036                             |Date position in bytes
  53.  
  54. #YOURNAMEPOS:001-012                            |Name position in bytes
  55. #YOURSIZEPOS:018-027                            |Size position in bytes
  56. #YOURDATEPOS:029-036                            |Date position in bytes
  57.  
  58. -------------------------------------------------:<EOF>                                                 
  59.  
  60. Descriptions:
  61.  
  62. #FLC
  63.  
  64. This must be left-justified on the first line.  FLC checks for this to make
  65. sure that it has a valid file.
  66.  
  67. #BBSLIST:source.lst
  68.  
  69. This is the name of the source list.  FLC will read in "source.lst" and then
  70. compare it to "compare.lst" and list the unique files that it finds in
  71. "source.lst".
  72.  
  73. #YOURLIST:compare.lst
  74.  
  75. This is the name of the list that the source list will be compared against.
  76.  
  77. #UNIQUELIST:unique.lst
  78.  
  79. This is the name of the file where the unique file names, size and date will
  80. be placed.
  81.  
  82. #CRITERIA:SD
  83.  
  84. This specifies additional criteria, besides name, that will be used to confirm
  85. whether a file is unique or not.  If an  "S" follows the ":" then size checking
  86. will be turned on.  If "S" is not there, then size checking will not be
  87. performed.  If a "D" follows the ":" then date checking will be turned on.  If
  88. a "D" is not present, then date checking will not be performed.  You can have
  89. both size and date checking if you so desire.  The logic is this:
  90.  
  91.         Do the names match?
  92.            NO  - it is a unique file
  93.                  EXIT
  94.  
  95.            YES - Are we checking dates?
  96.                  NO  - Proceed with size checking
  97.  
  98.                  YES - Do the dates match?
  99.                        NO - the file is unique
  100.                             EXIT
  101.  
  102.                - Are we checking file sizes?
  103.                  NO  - EXIT
  104.                  YES - Do the dates match?
  105.                        NO - the file is unique
  106.                             EXIT
  107.  
  108. #BBSNAMEPOS:bbb-eee
  109.  
  110. This is where FLC can expect to find the file name in each record/line of the
  111. list.  FLC parses our a lot of junk records at this point by looking for a
  112. "." in the file name.  If it does not find a period, it assumes that the
  113. record is invalid and it then proceeds to check for the next file name.
  114. bbb is the starting position in bytes (characters) from the left margin.
  115. eee is the ending position in bytes (characters) from the left margin.
  116. This is for the list named in #BBSLIST only.
  117.  
  118. #BBSSIZEPOS:bbb-eee
  119.  
  120. Where as #BBSNAMEPOS describes the posiition of the file names, #BBSSIZEPOS
  121. describes the location of each file listing's size entry.
  122.  
  123. #BBSDATEPOS:bbb-eee
  124.  
  125. And finally, this tells FLC where to find the date for each file entry in the
  126. files list.
  127.  
  128. #YOURNAMEPOS:bbb-eee
  129. #YOURSIZEPOS:bbb-eee
  130. #YOURDATEPOS:bbb-eee
  131.  
  132. These files all describe the locations of the name, size and date of each
  133. file entry in the list specified in #YOURLIST.
  134.  
  135. ==============================================
  136.  
  137. I suggest that you look at each list that you want to check and that you
  138. make a different config file for each list (if needed).  Play around with
  139. the position and criteria settings to find a match that best suits your needs.
  140.  
  141. ==============================================
  142.  
  143. 08/13/92  v2.0
  144.  
  145.           Completely rewrote the program!   This version is the result of
  146.           input from Tim Akright and a lot of input and debugging by Wayne
  147.           Keeter.
  148.  
  149.  
  150. Please Register This Program:
  151.  
  152. This program is the result of many hours of work.  It is also the result of
  153. my purchasing many computer languages, books and third party libraries. Only
  154. by your support can I continue to develop applications for the shareware
  155. market.  FLC is shareware, it is not public domain.  If you find that the
  156. program is useful, and you wish to continue using it, please register it
  157. for $10 per copy.  Please make payments in U.S. currency (please do not send
  158. cash) to:
  159.  
  160.         George Spafford
  161.         3001 Lakeshore Drive #329
  162.         Saint Joseph, MI 49085
  163.  
  164. I can be reached also by BBS on:  Queued Access 19200-8-N-1 USR DS
  165.                                   FIDO: 1:2340/0  Tim Akright Sysop
  166.  
  167. SHAREWARE DISTRIBUTORS:
  168.  
  169. You may distribute this program as long as it is made clear that you are
  170. only a distributor and that the program is not registered until they make
  171. payment to me.  Please do not charge more than $5 per disk to distribute 
  172. SDV to your customers.
  173.  
  174. ::::: Legal :::::
  175.      
  176. FLC IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES
  177. NO WARRANTIES OF APPROPRIATENESS, MERCHANTABILITY OR FITNESS FOR A
  178. PARTICULAR PURPOSE.  THE AUTHOR ASSUMES NO LIABILITY FOR ANY DAMAGES
  179. (INCLUDING LOST PROFITS, WAGES OR ANY OTHER CONSEQUENTIAL OR INCIDENTAL
  180. DAMAGES) ARISING OUT OF THE MISUSE OR INABILITY TO USE THIS PRODUCT.
  181.  
  182.